Basic Setup

Documentation / Administrator Docs / Developer Docs / Index / Administration Contents

The Basic Setup page allows you to define and change the basic settings for each of the four services running in the JavaServer.

The Basic Setup page has two screens:

General - Sets the basic features needed to operate your web server, such as the port, network addresses serviced, the index file loaded at connection, and the document root directory.
Advanced - Sets those basic features considered slightly more advanced, such as whether to perform security checks, how to display directories, to enable servlet chaining, and the directory in which to locate CGI scripts.

General Settings

The Basic Setup page has the following General fields and settings.

Port
Defines the port that your HTTP, Proxy, or HTTPS service listens on to field requests. A port number can be any number between 1 and 65535. (On UNIX, port numbers less than 1024 are considered "protected" ports and run as root. If you want to run your JavaServer on a port less than 1024, for example the default World Wide Web port 80, see Installation.)

The JavaServer default ports are:

Web Service (HTTP) - 8080
Secure Web Service (HTTPS) - 7070
Proxy Service - 6060
(Manage this tool) - 9090

Note: If you change the port number, you must restart the service by clicking the Restart button to have your change take effect.

Restart
Temporarily stops and then restarts the service so your changes can be saved and activated. It is only necessary to restart the service if you change the port.

Stop
If you choose, you can Stop a service rather than restart it. If you do this, the Restart button changes to read Start. To restart a stopped service, click Start.

Provide Service On
This field allows you to accept connections on more than one network address, if your machine is set up for multihoming. For example, if you have installed two interface cards, and one is set to le0 and one is set to le1, you can assign a single port (for example, 8080) to listen to requests that come in on both cards, or you can set your port to listen only a single card. If you set up your server to accept requests on only one card, requests that come in on the other card are ignored.

All Network Addresses - This sets your default port to listen to requests that come in on both (or all) network interface cards installed in your machine.
Network Address - This field sets your default port to listen to requests coming in on only the card specified. Enter the host name assigned to the card, or the IP Address. If you have more than one interface card installed, requests coming in on that card are ignored if this field is selected.

Special Note: The Proxy Service Basic Setup screen does not have entries for the Index.html File or Document Root Directory categories shown here under General Settings. Also, the Proxy Service Basic Setup screen has no Advanced Settings screen at all.

Index.html File
The name of the default HTML file the JavaServer loads when you enter the URL for your machine. In many cases this file is actually called index.html; however, you can enter the name of any file. This file becomes the default file the JavaServer loads when you connect to any directory on your machine.

For example, if you define the Index.html file to be myfile.html, whenever you connect to any directory that has a myfile.html file (and no other file name is specified in the URL), that file will be the default file displayed by the JavaServer.

To illustrate this, if your machine name is venus, and you define the Index.html File as space.html (and set the Document Root Directory to /home/galileo), then type the URL:

	http://venus:8080

you will display the file /home/galileo/space.html.

If there is no Index.html file defined in this field, and you connect to a directory on your machine without giving some other file name in the URL, the files in the directory will be listed by the JavaServer.

Document Root Directory
The name of the default directory on your machine where your HTML documents are placed. When you first install the JavaServer, the default document directory is server_root/public_html.

You can change this directory to be any directory you choose, for example, a docs directory inside your own home directory.

For example, if you are the user galileo on the machine venus, you could set your Document Root Directory to /home/galileo/docs. Then, to access this directory you would simply type the URL:

	http://venus:8080

The Proxy Service Basic Setup Screen

The Proxy Service Basic Setup screen has the following two fields, which the other service setups do not.

Local Server Names
The name of the local server machine (or machines) that will act as proxies. If the machine is known by more than one name (e.g., localhost, moxie), separate the names with commas.

Do Not Act as a Proxy For:
Use this field to list the machines inside a firewall that do not require proxy service. Separate multiple machine names with commas.

Advanced Settings

Security Checks
This setting has to do with basic security checking. It has two choices:

Enabled - Instructs the server to check access controls and permissions before allowing connections to your server document root and index.html file.
Disabled - Tells your server to ignore access controls and permissions when making connections to your server document root and index.html file. For more information on access controls and permissions, see Access Control Lists.

Directory Access
This setting has to do with what gets displayed in your default document root directory. It has two choices:

List Files - If you do not have a file in your document root directory specifically named index.html (or whatever you have entered in the Index.html field) that can be displayed when an HTTP connection is made to your JavaServer, a list of the files in the directory will be displayed instead.
Do Not List Files - If you do not have an index.html file (or substitute file) to be displayed when an HTTP connection is made, the directory files will not be displayed, and the user attempting to make the connection will not be granted access to your JavaServer.

Servlet Chains
This setting has to do with allowing servlets to be chained (that is, granting one servlet the permission to call and execute another servlet. For more information see Filters and Servlet Chaining). This setting has two choices:

Enabled - This allows servlets to chain to other servlets.
Disabled - This disables servlet chaining so that only the first servlet in a chain can be executed.

CGI Script Directory
This defines the directory where CGI scripts are found on your system. Any directory entered here is understood to be relative to server-root. For example, the default directory is cgi-bin, and the full path is server_root/cgi-bin.

Buttons

To make changes to the Basic Setup page and have those settings take affect, use the three buttons at the bottom of the screen. These are:

Save - Writes your changes to the JavaServer and changes the settings.
Revert - Takes you back to the previous settings for all fields in the screen. Use this button to undo changes you have not yet saved.
Defaults - Displays the settings that were active when you entered the JavaServer Basic Setup page.

Top

java-server-feedback@java.sun.com